home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / util / time / TitleClock1001.readme < prev    next >
Text File  |  1996-12-07  |  12KB  |  293 lines
  1. Short:    WB Titleclock, very configurable
  2. Author:   henryk.richter@stud.uni-rostock.de
  3. Uploader: henryk.richter@stud.uni-rostock.de
  4. Type:     util/time
  5.  
  6.  
  7.                        TitleClock 1.12 (20-Nov-96)
  8.                        ---------------------------
  9.                         by Henryk "Buggs" Richter
  10.  
  11.  
  12. Purpose
  13. -------
  14.  
  15. TitleClock is just another little Workbench Title digital clock but this
  16. time with some special features. I know that there are 1000 other ones out
  17. doing the same job but mine can do a little bit more. It was written to
  18. be used in combination tools like with "MultiCX" by Martin Berndt to replace
  19. almost all really important functions of programs like "Kcommodity" but
  20. consuming much less memory. It works 100% conform to the style guide and
  21. does not patch any system function. So it should run on any machine equipped
  22. with OS2.x/3.x. 
  23.  
  24.  
  25. A short list of features:
  26. -------------------------
  27.  
  28. - almost completely configurable output, e.g.
  29.   "OutPutFormat=%W, Time: %h:%n:%s  %D-%m-%Y ->DFT Rulez<-" causes it showing
  30.   "Saturday, Time: 20:42:12  10-Dec-1994 ->DFT Rulez<-"
  31. - appears at the right side of the workbench title and doesn`t open a
  32.   disturbing window
  33. - Workbench screen may be closed meanwhile Titleclock is active so you can
  34.   change your prefs without having to close any window.
  35. - Supports a "MEM"-gauge with a variable size from 10 Pixels to 990 Pixels
  36.   wide + selectable memory type to show
  37. - The program is a commodity so you can control it using Commodities
  38.   Exchange.
  39. - Can be easily removed by starting it again or sending a "break" signal
  40.   using a usual system monitor.
  41. - 100% font sensitive
  42. - detects automatically the colors used in titlebar
  43. - comes along with Icons for NewIcons AND MagicWB
  44. - re-entrant, 100% PC relative code
  45. - locale support using the standard strings so that this program works with
  46.   every localized language (Kick 2.1+)
  47. - startable from either WB or Shell
  48. - option to calculate the Stardate (TNG Norm)
  49. - quite short !! Hey, C and E programmers! Try to do this by using your
  50.   High-level languages, hehe
  51.  
  52.  
  53. Installation:
  54. -------------
  55.  
  56. Just drag the icon into the drawer you want. (usually sys:WBStartup)
  57.  
  58.  
  59. Starting:
  60. ---------
  61.  
  62. Double click onto the Icon. (What else)
  63.  
  64.  
  65. Configuration:
  66. --------------
  67.  
  68. The program countains no gui. This saves lots of memory from being wasted.
  69. Therefore the configuration is done using the tooltypes.
  70.  
  71.  
  72. OutPutFormat=????     Here you enter the line for your output string
  73.                       template. You may use any printable character and
  74.                       some offered variables. Those may be combined in any
  75.                       way you like (double, triple or even four times, no
  76.                       problem).
  77.                       The special variables:
  78.  
  79.                       %h -> hours in 24h military/European format
  80.                       %H -> hours in 12h American format
  81.                       %a -> "AM"/"PM"
  82.  
  83.                       %n -> minutes
  84.                       %s -> seconds
  85.  
  86.                       %D -> day
  87.  
  88.                       %N -> month as number
  89.                       %m -> month as short string (Jan,Feb,Mar...)
  90.                       %M -> month as string
  91.  
  92.                       %y -> year as 2 decimal numbers "94"
  93.                       %Y -> year as 4 decimal numbers "1994"
  94.  
  95.                       %w -> weekday as short string (Mon,Tue,Wed...)
  96.                       %W -> weekday as string
  97.  
  98.                       %% -> Just inserts a "%" char
  99.  
  100.                       %S -> Startrek TNG Stardate
  101.                             Descriptions of the algorithms can be found in
  102.                             the TNG and TOS Startrek FAQ`s
  103.                             Short explanation how I did it:
  104.                              example output: "05085.6"
  105.                             -the first digit is the current century (2"0"th)
  106.                             -the second is the Startrek season in the
  107.                              series and the movies. I used the last digit
  108.                              of the current year here since it is stated in
  109.                              the FAQ that this one increases every year
  110.                             -the next 3 digits are the portion of the
  111.                              current year from 0...999, which means:
  112.                              number of the current day (0..365) *1000/365
  113.                             -the ".6" represents the portion of the actual
  114.                              day divided through "2.4".
  115.                             If someone tells me how to convert gregorian
  116.                             date into the julian calendar, I`ll perhaps add
  117.                             an option for the TOS Stardate.
  118.                       %# -> inserts the number of the current week
  119.  
  120.  
  121.  
  122.   Examples: OutPutFormat=Time: %h:%n%:%s  Date: %D-%M-%Y
  123.             OutPutFormat=This day is %h hours, %n minutes and %s seconds old
  124.             OutPutFormat=%W, %N-%D-%y %h:%n:%s
  125.  
  126. Gauge=??              This tooltype is for the mem bar showing the amount
  127.                       of free memory. If the (normally blue) bar reaches
  128.                       the right side, your memory is full. :(
  129.                       You may change the width of this gauge by entering
  130.                       values from 1 to 99. A value of 1 represents a width
  131.                       of 10 pixels.
  132.   Example: Gauge=5
  133.  
  134. Memtype=0x??          Here you can enter a c-style hexadecimal mask which
  135.                       type of mem is to be shown in the gauge. It works with
  136.                       standard exec-style Type definitions. (look into the
  137.                       examples, DUDE!)
  138.   Examples: Memtype=0x4   ... shows only free Fastmem
  139.             Memtype=0x2   ... shows only free Chipmem
  140.             Memtype=0x0   ... shows complete free memory
  141.             Memtype=0x1   ... shows Chip- and Fastmemory but not Virtual
  142.                               memory created e.g. by Gigamem® or VMM.
  143.             Memtype=0x20000 . shows largest free memory block
  144.             Memtype=0x20004 . shows largest free Fastmemory block
  145.             .
  146.             .
  147.             .
  148.  
  149.  
  150. Known Bugs / Problems
  151. ---------------------
  152.  
  153. Due to the display system blitting into the Workbench Titlebar Layer
  154. the display may disappear every time you change the current window or
  155. when the amount of free memory changes. I could change this behaviour
  156. but I didn`t want to open a window AND I hate too much patches.
  157.  
  158. If you set the Program`s "toolpri" lower than 0 it may/will happen that
  159. some programs using 100% of the CPU time (like PC-Task) can cause a 
  160. graphics deadlock. That happens when the blitter is already allocated by
  161. those functions used by Titleclock and then the CPU time is stolen by the
  162. Task with the higher priority. If you always use a priority of 5 (default
  163. setting) there shouldn`t be any problems. THE PROGRAM WILL NOT USE MORE 
  164. CPU TIME IN THIS CASE !
  165.  
  166.  
  167. History
  168. --------
  169.  
  170. 1.12 - added %# for the current week`s number
  171.  
  172. 1.11 - internal version
  173.      *not released*
  174.  
  175. 1.10 - minor Bugfix, Titleclock reopened the Workbench screen automatically
  176.        when it was closed by a program. Now it won`t do so.
  177.  
  178. 1.08 - Bugfix, the OS2.0/2.1 versions of Titleclock tried to open the V39
  179.        commodities.library instead of V37
  180.      - ASM-Sourcecode included
  181.  
  182. 1.07 - the program now be started from shell, the options are still read
  183.        from the Icon in this case
  184.      - small Bugfix, using the Kickstart 2.0/2.1 version it was possible
  185.        that the memgauge wasn`t shown correct when using non standard
  186.        screen widths
  187.  
  188. 1.06 - the AM/PM showed 12 AM at high noon instead of 12 PM, fixed
  189.  
  190. 1.05 - added the Stardate(TM) option
  191.  
  192. 1.04 - fixed a minor bug, I just forgot to free the workbench screen`s
  193.        drawinfo structure
  194.      - added 12h / PM displaying modes since I were asked to
  195.      *not released*
  196.  
  197. 1.03 - wrote a version for Kickstart 2.0 (english only)
  198.      - from Kick 2.1 onwards now localization supported
  199.      - added some additional security checks
  200.      - added the memtype option for the mem-gauge
  201.      - little "bug" fixed causing some characters not to be deleted when
  202.        using certain proportional fonts (added a space of 6 pixels)
  203.  
  204. 1.02 - added a version with german strings, made the code re-entrant to 
  205.        save some bytes
  206.  
  207. 1.01 - added the mem-gauge
  208.  
  209. 1.00 - first non public testrelease
  210.  
  211.  
  212. Author
  213. ------
  214.  
  215.                          Henryk Richter
  216.                          (Buggs/Defect)
  217.                      Stephan Jantzen Ring 47
  218.                          18106 Rostock
  219.                             Germany
  220.  
  221.            E-MAIL: tfa652@cks1.rz.uni-rostock.de (preferred)
  222.                    henryk.richter@stud.uni-rostock.de
  223.                    rh64@warnow.e-technik.uni-rostock.de
  224.  
  225.  
  226. Legal Stuff
  227. -----------
  228.  
  229. Titleclock IS Freeware, so use it the way you like.
  230.  
  231.  
  232. Copyright
  233. ---------
  234.  
  235. Titleclock is written and copyright © 1994-96 by Henryk Richter.
  236. No parts of this program may be altered in any way (this 
  237. includes editing, reprogramming, crunching, resourceing etc.),
  238. except archiving. The sourcecode is only included for learning
  239. purposes.
  240.  
  241.  
  242. Disclaimer
  243. ----------
  244.  
  245.    THERE  IS  NO  WARRANTY  FOR  THE  PROGRAMS,  TO  THE  EXTENT  PERMITTED BY
  246. APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS
  247. AND/OR  OTHER  PARTIES  PROVIDE  THE  PROGRAMS "AS IS" WITHOUT WARRANTY OF ANY
  248. KIND,  EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  249. WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A PARTICULAR PURPOSE.  THE
  250. ENTIRE  RISK  AS  TO  THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS WITH YOU.
  251. SHOULD  THE  PROGRAMS  PROVE  DEFECTIVE,  YOU ASSUME THE COST OF ALL NECESSARY
  252. SERVICING, REPAIR OR CORRECTION.
  253.  
  254.    IN  NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  255. ANY  COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAMS AS
  256. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  257. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  258. THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  259. INACCURATE  OR  LOSSES  SUSTAINED  BY YOU OR THIRD PARTIES OR A FAILURE OF THE
  260. PROGRAMS  TO  OPERATE  WITH  ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
  261. PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  262.  
  263. Shorter: use it on your own risk...
  264.  
  265.  
  266. Distribution
  267. ------------
  268.  
  269. The Distributor may only charge a fee up to the costs of obtaining any
  270. common public domain disk. The distributor agrees to stop distributing the
  271. programs and data involved on request of the author.  The distributor may
  272. only distribute an unmodified copy of the original program, with all the
  273. supplied documentation and copyright notices left intact. The amount of
  274. US $5 shouldn't be exceeded for a disk containing Titleclock.
  275.  
  276.  
  277. ============================= Archive contents =============================
  278.  
  279. Original  Packed Ratio    Date     Time    Name
  280. -------- ------- ----- --------- --------  -------------
  281.     1745     637 63.4% 11-Sep-95 15:26:30  Titleclock1001.info
  282.    10820    4637 57.1% 20-Nov-96 19:44:42 +TitleClock1001.doc
  283.     3040    2294 24.5% 11-Sep-95 15:14:00 +TitleClock1001.doc.info
  284.    29015    8970 69.0% 20-Nov-96 19:25:12 +TitleClock1001.s
  285.     3600    2491 30.8% 20-Nov-96 19:24:38 +TitleClock1001_2.0
  286.     3000    1546 48.4% 11-Sep-95 15:14:00 +TitleClock1001_2.0.info
  287.     3468    2422 30.1% 20-Nov-96 19:24:28 +TitleClock1001_2.1
  288.     3001    1548 48.4% 11-Sep-95 15:14:02 +TitleClock1001_2.1.info
  289.     3340    2326 30.3% 20-Nov-96 19:24:58 +TitleClock1001_3.x
  290.     3002    1551 48.3% 11-Sep-95 15:14:02 +TitleClock1001_3.x.info
  291. -------- ------- ----- --------- --------
  292.    64031   28422 55.6% 23-Nov-96 23:54:16   10 files
  293.